Skip to main content

Notes​

  • This API supports partial updates. Apart from robotSn, planUuid, operationType, year, month, and dayOfMonth, send only fields that need to change. Omitted business fields retain their existing values; sending null is not recommended.
  • year, month, and dayOfMonth only identify the target date. operationType=1 updates only that date, while operationType=2 updates that date and all future schedules.
  • If supplied, mapResourceList replaces the entire existing list. Every item requires mapId, mapResourceId, and mapResourceType, using actual values from /openapi/v3/maps/schedule-resources/list.
  • If supplied, workMode.mode is required and all fields must be based on the actual resource-query response; see Task Work Mode Reference for field definitions. If mode alone is ambiguous, also send subType, type, or strength.
  • taskAdvanceConfig is merged by child field; omitted child fields retain their existing values.
  • Mutation APIs use integer planExecuteType: 1 for a timed task or 2 for a quantitative task. For a quantitative task, send "planStopTime": "" to clear the existing end time. A timed task cannot have an empty end time.
  • Times use HH:mm in 24-hour format. A non-empty end time must be later than the start time; crossing midnight is not supported.